home *** CD-ROM | disk | FTP | other *** search
/ Aminet 51 / Aminet 51 (2002)(GTI - Schatztruhe)[!][Oct 2002].iso / Aminet / dev / misc / FlexCat.readme < prev    next >
Encoding:
Text File  |  2002-08-10  |  6.0 KB  |  141 lines
  1. Short:    2.6 - Flexible catalogs (C, Asm, Oberon, E, ARexx, Modula...)
  2. Author:   marcin@orlowski.com (Marcin Orlowski)
  3. Uploader: ensonic@sonicpulse.de (Stefan Kost)
  4. Version:  2.6
  5. Type:     dev/misc
  6. Www:      http://amiga.com.pl/flexcat/
  7.  
  8.  
  9.  
  10.   INFO
  11.   ----------
  12.  
  13.     FlexCat creates catalogs and the source to handle them.  The difference
  14.   between FlexCat and KitCat, CatComp and some others is, that FlexCat is
  15.   designed to produce any source you want:  any programming language, any
  16.   individual needs should be satisfied.  However, FlexCat is not more
  17.   difficult to use.
  18.  
  19.     Translators will also find it useful, as, among standard functions
  20.   like #?.catalog creation, FlexCat is able to update your #?.ct files
  21.   to the new #?.cd files automatically. Give it a try! 
  22.  
  23.     This sounds like a contradiction.  FlexCat's solution is to use
  24.   template files, the so called "source descriptions".  Ready to use examples
  25.   for Assembler, C, C++, E, Oberon and Modula-2 are distributed, additionally
  26.   an example for supporting catalogs on Workbench 2.0.  Any other examples
  27.   are welcome.
  28.  
  29.  
  30.   Archives
  31.   ----------
  32.  
  33.     Since release 2.0, the FlexCat distribiution is splitted into the
  34.   smaller archives. They are (in order of importance):
  35.  
  36.   FlexCat.lha           - Latest FlexCat, user contribitions, english manual
  37.                          and foreign catalog files
  38.  
  39.   FlexCat_0x0.lha       - patches for 020, 040 and 060 versions of FlexCat
  40.                          (PPC makes no sense here. I checked that).
  41.  
  42.   FlexCat_ExDocs.lha    - FlexCat's guide in non english languages. Currently
  43.                          Svenska, Espanol and Deutsch are provided
  44.  
  45.   FlexCat_CatSrc.lha    - #?.cd and #?.ct files for existing translations and
  46.                          #?.texinfo documents
  47.  
  48.   FlexCat_Src.lha       - C source code for the FlexCat itself
  49.  
  50.   FlexCat_Demos.lha     - example source codes -> shows how to make localized
  51.                           programs using FlexCat (C/HSPascal/ARexx/etc)
  52.  
  53.                           NOTE: I would gladly welcome examples for other
  54.                           languages (E/Asm etc) as well as detailed tutorials 
  55.                           about right way of doing localized software.
  56.                           Your contribution is highly welcome!
  57.  
  58.  
  59.   If you just want to use FlexCat, the 1st archive is all you need.
  60.   If you want to have CPU optimised binaries, take both 1st and 2nd
  61.   and patch the original release.  If you want to read translated manual,
  62.   get the 3rd one.  If you want to make the translation take the 4th one
  63.   (but I suggesto to join the Amiga Translators' Organisation
  64.   <http://ato.vapor.com/ato> first!)
  65.  
  66.  
  67.   Changes since previous release:
  68.   -------------------------------
  69.   * v2.6 (06.08.02) - FlexCat now updates the Date when creating the .catalog
  70.                       file from the .ct, no need for $TODAY anymore
  71.                     - FlexCat now even corrects the filename in the version
  72.                       string, '<file>.ct' becomes '<file>.catalog'
  73.                     - some fixes to the english docs
  74.                     - docs can now be compiled from the Makefile
  75.                     - when creating a blank ct from cd the version gets
  76.                       copied from the .cd file and the wrong warning is
  77.                       removed
  78.                     (Stefan Kost <ensonic@sonicpulse.de>)
  79.  
  80.   * v2.5b (19.03.02)- Added GG patchfile, thanks to Martin Blom <martin@blom.org>
  81.  
  82.  
  83.   * v2.5 (14.02.02) - Fixed the problem, if using $TODAY, that the date was
  84.                       one day ahead (tomorrow ;). Replaced gmtime() with
  85.                       localtime() (DMX).
  86.  
  87.  
  88.   * v2.4 (28.11.99) - FlexCat is now portable! Thanks to Hardcode.sd{tm}
  89.                       unique technology you can now try to compile FlexCat
  90.                       under any OS (both Big and Little Endians are
  91.                       supported). Read developer.readme for details.
  92.  
  93.                     - sometimes garbage could be written instead of
  94.                       $VER: string (when $TODAY feature was used) due
  95.                       to memory block being free'd before write.
  96.  
  97.                     - added ##rem command to .sd file handling. As you
  98.                       have probably guessed, it's just remark. The goal
  99.                       (at least for me) is that ##rem lines won't appear
  100.                       in result source code, creaded out of the .sd file.
  101.  
  102.                     - added manual catalog open/close for compilers that
  103.                       do not handle autoinit/exit functions
  104.  
  105.                     - Updated french translation (Herve Dupont
  106.                       <herve.dupont@nordnet.fr>)
  107.  
  108.                     - Added NOSPACE switch, to avoid extra space char
  109.                       usually used by FlexCat to separate comment
  110.                       mark ';' from the main comment text
  111.  
  112.                     - Source descriptor for HSPascal by Artur Karpunin
  113.                       <woody8@kki.net.pl> is now available.
  114.  
  115.                     - New archive "FlexCat_Demos" full ;-) of example
  116.                       source codes for various programming languages
  117.                       C, HSPascal and ARexx examples are recently
  118.                       available.
  119.  
  120.                     - Content of "Contribution" drawer is now moved to
  121.                       "FlexCat_Demos" archive.
  122.  
  123.                     - Added detailed tutoral (in polish for now) about
  124.                       the whole localization process (incl. examples)
  125.  
  126.  
  127.   * v2.3 (19.05.99) - "Trailing ellipsis" detector was broken (Marco
  128.                       De Vitis <marco.dvv@flashnet.it>)
  129.  
  130.                     - Seems I updated the english manual for v2.2, but
  131.                       forgot to create .guide file out of texinfo.
  132.  
  133.                     - Fixed manual to say "1999" instead of "1998", and
  134.                       fixed #?.cd file to show proper arguments when
  135.                       help ("?") is requested (Herve Dupont
  136.                       <herve.dupont@nordnet.fr>)
  137.  
  138.                     - Spanish translation by Sergio Martín Rodríguez
  139.                       <smartin@kaos.es> and Tomás J. Cantó
  140.                       <tjcanto@redestb.es>
  141.